home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / wc35desc.zip / WC35DESC.DOC < prev    next >
Text File  |  1992-07-15  |  7KB  |  191 lines
  1.  
  2.  
  3.  
  4.                WC35DESC V1.0   (c) Copyright 1992 by Gary Gesmundo
  5.                                All Rights Reserved
  6.  
  7.                              For Wildcat! 3.5+ ONLY!
  8.  
  9.                                   What it Does
  10.  
  11.         WC35DESC is a utility program for Wildcat Version 3.5x which will
  12.         automatically add file descriptions to the Wildcat database.  The
  13.         program will add the 60 character short description, kept in  the
  14.         Files database as well as the extended description.  The  program
  15.         will not currently work with any version of Wildcat prior to 3.5.
  16.  
  17.                                   How It Works
  18.  
  19.         WC35DESC  checks uploaded .ZIP, .LZH and .ARJ files  (all  others
  20.         are  ignored) for the presence of a DESC.SDI file.  If this  file
  21.         is  found  its description is placed in the WC3.5  File  database
  22.         short  description.   If  the DESC.SDI file is not  found  and  a
  23.         FILE_ID.DIZ is present, WC35DESC will place the first line of its
  24.         description  in the short description.  Next a check is made  for
  25.         the  FILE_ID.DIZ  file  and if present the text  it  contains  is
  26.         placed  in the extended description.  Since this process  happens
  27.         after  the file database record is created, any  description  en-
  28.         tered by the user will be over written.
  29.  
  30.  
  31.                                Installing WC35DESC
  32.  
  33.  
  34.         1.   Ensure  that PKUNZIP.EXE, ARJ.EXE and LHARC.EXE may  be  run
  35.              from the WC30 home directory or are in the path.
  36.  
  37.         2.   Ensure WCNODEID is set for the node from which WC35DESC will
  38.              be  run.  The  WCNODEID is used to determine  the  path  for
  39.              storage  of temporary files.  I.E., in your autoexec.bat  or
  40.              cat.bat  file use the following DOS command: SET  WCNODEID=1
  41.              for node 1 etc.  This is required even if you are running  a
  42.              single line system.
  43.  
  44.         3.   Ensure the current version of WCFILE.EXE is in your PATH  or
  45.              WC30 Home directory.
  46.  
  47.         4.   Put WC35DESC.EXE in the WC30 home directory or in your PATH.
  48.  
  49.         5.   Create or add to your existing SCANFILE.BAT in the WC30 home
  50.              directory the following line:
  51.  
  52.                                 WC35DESC %1 /t/n
  53.  
  54.         The  /t and /n are optional. The /t option will use  todays  date
  55.         for  the file database record and will cause the file to show  up
  56.         in the new files listing.  The default is the files date.  The /n
  57.         option  will suppress the creation of keys in the file data  base
  58.         record.  The default is to create keys from the description.
  59.  
  60.  
  61.                                         1
  62.  
  63.  
  64.  
  65.         If   you  change  drives or path in your SCANFILE.BAT  prior   to
  66.         executing WC35DESC make sure to change the drive/path back to the
  67.         WC30 home directory, i.e. CD\WC30, prior to running WC35DESC.
  68.  
  69.  
  70.         WC35DESC works with dial up as well as LOCAL uploads and can save
  71.         a  lot  of  time entering descriptions.  A couple  of  things  to
  72.         remember and tell your users are:
  73.  
  74.         1.   The short description allows 60 characters max. (DESC.SDI)
  75.         2.   The  FILE_ID.DIZ has been somewhat standardized at 15  lines
  76.              of 45 characters each.
  77.  
  78.         Wildcat will accept descriptions longer than 45 characters in the
  79.         extended  description  and WC35DESC will NOT chop  off  any  text
  80.         exceeding  these  limits.  Wildcat will only allow  15  lines  of
  81.         extended description and any lines past 15 will be lost.
  82.  
  83.  
  84.                    Running WC35DESC from the DOS Command Line.
  85.  
  86.  
  87.         WC35DESC   uses  the  freshen  option   of   WCFILE,    therefore
  88.         descriptions    may  be  updated  by  using  WC35DESC  from   the
  89.         DOS  command line.  Following are some sample command lines:
  90.  
  91.  
  92.                         WC35DESC Drive:\Path\Filename.ext
  93.  
  94.  
  95.         The  above  command  line would update the file  database  for  a
  96.         single  ZIP, ARJ or LZH archive.  You may also use the /n and  /t
  97.         options  as  described above.  The drive and  path  are  compared
  98.         against  the entries in the  Wildcat  FILEAREA.DAT file and  must
  99.         exist  for WC35DESC to work.   If no matching entry can be  found
  100.         WC35DESC will exit and do nothing.
  101.  
  102.  
  103.                                    WC35DESC /1
  104.  
  105.  
  106.         This  command would update descriptions for all the ZIP, ARJ  and
  107.         LZH archives in file area 1.  As before use the /t option to  set
  108.         the  file dates to todays date and/or the /n option  to  suppress
  109.         generation of keys from the descriptions.
  110.  
  111.  
  112.                                   WC35DESC /ALL
  113.  
  114.  
  115.         This  command would update descriptions for all the ZIP, ARJ  and
  116.         LZH  archives in ALL file areas.  As before use the /t option  to
  117.         set  the file dates to todays date and/or the /n option  to  sup-
  118.         press generation of keys from the descriptions.
  119.  
  120.  
  121.  
  122.                                         2
  123.  
  124.  
  125.  
  126.         Although  WC35DESC has been carefully tested, I make no  warranty
  127.         as  to  its usability, results of its use, or safety to  data.  I
  128.         accept  no responsibility for any problems, loss or damages  that
  129.         occur, whether directly or indirectly, as a result of it's use.
  130.  
  131.  
  132.         This  program  is being distributed as PauperWare.  If  you   can
  133.         afford  to send a contribution please do.  $10 to $15 would be  a
  134.         fair amount.  If not enjoy the  program  in  good health and drop
  135.         us  a line to let us know  you  are using  it.  The  program  may
  136.         not be sold, but may  be  distributed freely providing all  files
  137.         in the original archive are included.
  138.  
  139.  
  140.         Many  thanks  to  Phil  Pattengale  of  The Graphics Shop BBS  in
  141.         Kalamazoo, MI 616-375-2083 1:2201/23 for all the  help and ideas!        
  142.         He was brave enough to be the second system to try WC35DESC. He's 
  143.         even still using it and is still my friend.
  144.  
  145.  
  146.         Comments, suggestions, bug reports and constructive criticism are
  147.         always  welcome.  Please contact me at the address or phone  num-
  148.         bers listed below.
  149.  
  150.  
  151.                                   Gary Gesmundo
  152.                                  10301 East M89
  153.                                Richland, MI 49083
  154.                              616-629-5801 voice days
  155.                              616-671-4694 voice eves
  156.                              616-629-4354 BBS 24 hrs
  157.                            The Freq Shop BBS 1:2201/29
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.                                         3
  190. 
  191.